home *** CD-ROM | disk | FTP | other *** search
/ Over 1,000 Windows 95 Programs / Over 1000 Windows 95 Programs (Microforum) (Disc 1).iso / 0860 / read.me < prev    next >
Encoding:
Text File  |  1997-04-12  |  6.1 KB  |  146 lines
  1.  
  2.                    XPLAN -- AUTOMATE UPDATING OF .PLAN FILE
  3.                                        
  4.    XPlan version 0.3 Built day: June 24, 1995
  5.    
  6. What's XPlan?
  7.  
  8.    If you are using dynamic address, it's real hard for your friends to
  9.    find out what address you are using or even if your are online or not.
  10.    You can use XPlan to upload your dynamic address to your .plan file in
  11.    an account in a permanent host(like your account in your Internet
  12.    provider) everytime you login or logout of a SLIP/PPP section.
  13.    
  14. Requirement:
  15.  
  16.    You need VBRUN300.DLL to run this program, also MS-Windows3.1(or up)
  17.    running Winsock 1.1 or up.
  18.    
  19. Installation:
  20.  
  21.    After unzip the package into a directory, run setup.exe from that
  22.    directory under MS-Windows.
  23.    
  24. Command Line Options:
  25.  
  26.    XPlan receives two command line options: log_in and log_out. Why these
  27.    two? read on for more details.
  28.    
  29. Running:
  30.  
  31.    If you run XPlan for the first time, it will need some information
  32.    about you and your remote account. That includes the name of remote
  33.    host you want to put the .plan file, your login ID on that host, your
  34.    password on that host, and the name you prefer to be called. You enter
  35.    these only once. XPlan will save these to a file and load them next
  36.    time you run XPlan again. If XPlan successfully updates your remote
  37.    .plan file, your .plan file will look like this:
  38.  
  39.    [Some of you regular .plan texts at here]
  40.    My local address is your_name@your_local_host_name
  41.  
  42.    For compatible reason, you shouldn't specify your name longer than 12
  43.    characters. Your friends who finger(using any finger client, e.g. my
  44.    Xfinger) your UNIX account can know if you are online or not, and
  45.    where are you. Then he/she can talk to you by typing
  46.    talk your_name@your_local_host_name.
  47.    (I also have a talk client, xtalk. I am working on server part right
  48.    now).
  49.    If you want to add more texts on top of that one line message in the
  50.    same .plan file, you can put them in a file called xplan.txt in the
  51.    directory where you installed xplan. XPlan.txt along with the above
  52.    message will be your .plan file. I provided a simple xplan.txt with
  53.    this package. You should modify it to suit your need.
  54.    
  55. Script File:
  56.  
  57.    I am using trumpet winsock. The following example is done in that
  58.    script language. Other Winsock script language should have similar
  59.    functions. In trumpet, you can execute a program using "exec" command
  60.    in you script. To automate updating of your .plan file, you can put an
  61.    "exec" right after the part that winsock fires up SLIP function.
  62.    exec "c:\xplan\xplan.exe log_in"
  63.    Of course, you should modify the path if you installed xplan in a
  64.    different path. This will put that magic
  65.    message(your_name@your_local_host_name) in your remote .plan file. For
  66.    some reasons, you can not execute a program in Trumpet's bye.cmd.
  67.    Therefore, to update .plan file when you logout of a section, you have
  68.    to click on Logout option in XPlan. XPlan will first upload a new
  69.    .plan file to remote host without magic message. Then it will
  70.    disconnect Trumpet for you automatically.
  71.    If you use other Winsock stacks, XPlan will not disconnect winsock
  72.    connection automatically(it still update your .plan file). I will
  73.    revise this limitation when I have time.
  74.    Of course, if you don't want to run xplan from your script file, you
  75.    still can launch it from program manager.
  76.    
  77. Supporting Files
  78.  
  79.    There are two files you need to put in right directory, xplan.ini and
  80.    xplan.txt. If you run XPlan from login.cmd, you should put them into
  81.    the directory where you run tcpman.exe. If you run XPlan from command
  82.    line(i.e. from program manager), you should put them in the same
  83.    directory as where you put XPlan.exe.
  84.    
  85. Problems?
  86.  
  87.    Before you use XPlan, you should make sure that the permission of your
  88.    original .plan file is 644, i.e. world readable. To change permission
  89.    of this file, typing chmod 644 ~/.plan in your UNIX account. You
  90.    should make a .plan file and set it to that permission if you do not
  91.    have one. Because the permission of new .plan will be the same as the
  92.    permission of old one.
  93.    
  94. Security Issue:
  95.  
  96.    This program needs your password to run. The reason is obvious. It
  97.    needs to gain access to your account inorder to update your .plan
  98.    file. I try the best I can to hide your password(using encryption).
  99.    Some things you should know:
  100.    1. Never get this package(XPlan) from unknown sites. The best place to
  101.    get it is my WWW
  102.    page(http://www.ugrad.cs.ubc.ca/spider/q7f192/tools.html). I will also
  103.    upload it to SimTel and CICA.
  104.    2. Never expose xplan.ini to anyone. That file contains encrypted
  105.    password. Somebody might try to decrypt it.
  106.    3. Change your password often.
  107.    Did I mention how to change password for xplan. For now, you have to
  108.    delete the entry in xplan.ini inorder to enter new data for that
  109.    entry(you name, your host, etc.). Delete the whole line contains that
  110.    entry, the next time xplan will ask you to enter that entry again. I
  111.    might add some functions to do that inside of xplan.
  112.    
  113. Availability
  114.  
  115.    Latest XPlan can be found at:
  116.     http://www.ugrad.cs.ubc.ca/spider/q7f192/branch/tools.html
  117.    
  118.    Did I mention that this program is FREE!
  119.    
  120.    DISCLAIMER: I AM NOT RESPONSIBLE FOR ANY DAMAGE THAT THIS PROGRAM MAY
  121.    CAUSE. YOU USE IT ON YOUR OWN RISK!
  122.    
  123.    All brand names and trademarks are the property of their respective
  124.    owners
  125.    
  126.     _________________________________________________________________
  127.    
  128.     XPlan Copyright (C) 1995
  129.     George Xie / q7f192@ugrad.cs.ubc.ca
  130.  
  131.  
  132. FILE_ID.DIZ
  133.  
  134. (V0.3) XPlan - Win File/Winsock
  135. Xplan can update your .plan file everytime 
  136. you log into your SLIP/PPP connection. 
  137. XPlan adds a a message at the end of your
  138. .plan file indicating what's your current
  139. address. When you logout, the .plan file is
  140. also updated to get rid of that message.
  141. It's very useful for dynamic address users,
  142. also for permanent address owners.
  143. It's freeware
  144. George Xie,  q7f192@ugrad.cs.ubc.ca
  145. http://www.ugrad.cs.ubc.ca/spider/q7f192
  146.